home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / MrmFetchBitmapLiteral.z / MrmFetchBitmapLiteral
Encoding:
Text File  |  1998-10-20  |  6.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll - Fetches a bitmap literal from a
  10.           hierarchy
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<MMMMrrrrmmmm////MMMMrrrrmmmmPPPPuuuubbbblllliiiicccc....hhhh>>>>
  14.  
  15.           CCCCaaaarrrrddddiiiinnnnaaaallll MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((_h_i_e_r_a_r_c_h_y__i_d, _i_n_d_e_x, _s_c_r_e_e_n, _d_i_s_p_l_a_y, _p_i_x_m_a_p__r_e_t_u_r_n, _w_i_d_t_h, _h_e_i_g_h_t))))
  16.                MMMMrrrrmmmmHHHHiiiieeeerrrraaaarrrrcccchhhhyyyy_h_i_e_r_a_r_c_h_y__i_d;;;;
  17.                SSSSttttrrrriiiinnnngggg    _i_n_d_e_x;;;;
  18.                SSSSccccrrrreeeeeeeennnn    ****_s_c_r_e_e_n;;;;
  19.                DDDDiiiissssppppllllaaaayyyy   ****_d_i_s_p_l_a_y;;;;
  20.                PPPPiiiixxxxmmmmaaaapppp    ****_p_i_x_m_a_p__r_e_t_u_r_n;;;;
  21.                DDDDiiiimmmmeeeennnnssssiiiioooonnnn ****_w_i_d_t_h;;;;
  22.                DDDDiiiimmmmeeeennnnssssiiiioooonnnn ****_h_e_i_g_h_t;;;;
  23.  
  24.  
  25.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  26.           This page documents version 1.2 of the Motif library.
  27.  
  28.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.           The MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll function fetches a bitmap literal
  30.           from an MRM hierarchy, and converts the bitmap literal to an
  31.           X pixmap of depth 1.  The function returns this pixmap and
  32.           its width and height.
  33.  
  34.  
  35.           _h_i_e_r_a_r_c_h_y__i_dSpecifies the ID of the UID hierarchy that
  36.                       contains the specified icon literal.  The
  37.                       _h_i_e_r_a_r_c_h_y__i_d was returned in a previous call to
  38.                       MMMMrrrrmmmmOOOOppppeeeennnnHHHHiiiieeeerrrraaaarrrrcccchhhhyyyyPPPPeeeerrrrDDDDiiiissssppppllllaaaayyyy.
  39.  
  40.           _i_n_d_e_x       Specifies the UIL name of the bitmap literal to
  41.                       fetch.
  42.  
  43.           _s_c_r_e_e_n      Specifies the screen used for the pixmap.  The
  44.                       _s_c_r_e_e_n argument specifies a pointer to the Xlib
  45.                       structure SSSSccccrrrreeeeeeeennnn which contains the information
  46.                       about that screen and is linked to the DDDDiiiissssppppllllaaaayyyy
  47.                       structure.  For more information on the DDDDiiiissssppppllllaaaayyyy
  48.                       and SSSSccccrrrreeeeeeeennnnstructures, see the Xlib function
  49.                       XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy and the associated screen
  50.                       information macros.
  51.  
  52.           _d_i_s_p_l_a_y     Specifies the display used for the pixmap.  The
  53.                       _d_i_s_p_l_a_y argument specifies the connection to the
  54.                       X server.  For more information on the DDDDiiiissssppppllllaaaayyyy
  55.                       structure, see the Xlib function XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy.
  56.  
  57.           _p_i_x_m_a_p__r_e_t_u_r_n
  58.                       Returns the resulting X pixmap value.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV MMMMrrrrmmmmFFFFeeeettttcccchhhhBBBBiiiittttmmmmaaaappppLLLLiiiitttteeeerrrraaaallll((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _w_i_d_t_h       Specifies a pointer to the width of the pixmap.
  75.  
  76.           _h_e_i_g_h_t      Specifies a pointer to the height of the pixmap.
  77.  
  78.  
  79.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  80.           This function returns one of these status return constants:
  81.  
  82.  
  83.           MMMMrrrrmmmmSSSSUUUUCCCCCCCCEEEESSSSSSSS          The function executed successfully.
  84.  
  85.           MMMMrrrrmmmmBBBBAAAADDDD____HHHHIIIIEEEERRRRAAAARRRRCCCCHHHHYYYY    The hierarchy ID was invalid.
  86.  
  87.           MMMMrrrrmmmmNNNNOOOOTTTT____FFFFOOOOUUUUNNNNDDDD        The bitmap literal was not found in the
  88.                               hierarchy.
  89.  
  90.           MMMMrrrrmmmmWWWWRRRROOOONNNNGGGG____TTTTYYYYPPPPEEEE       The caller tried to fetch a literal of a
  91.                               type not supported by this function.
  92.  
  93.           MMMMrrrrmmmmFFFFAAAAIIIILLLLUUUURRRREEEE          The function failed.
  94.  
  95.  
  96.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  97.           MMMMrrrrmmmmFFFFeeeettttcccchhhhIIIIccccoooonnnnLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))), MMMMrrrrmmmmFFFFeeeettttcccchhhhLLLLiiiitttteeeerrrraaaallll((((3333XXXX)))), and
  98.           XXXXOOOOppppeeeennnnDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))).
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.